home *** CD-ROM | disk | FTP | other *** search
SSSSEEEENNNNDDDDFFFFAAAAXXXX((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((JJJJuuuunnnneeee 22221111,,,, 1111999999996666)))) SSSSEEEENNNNDDDDFFFFAAAAXXXX((((1111)))) NNNNAAAAMMMMEEEE sendfax - submit a facsimile job for transmission SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS sssseeeennnnddddffffaaaaxxxx [ _o_p_t_i_o_n_s ] [ _f_i_l_e_s... ] DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN _s_e_n_d_f_a_x submits one or more facsimile transmission requests to a _H_y_l_a_F_A_X facsimile server. Requests are normally processed immediately, although they may also be queued for transmission at a later time using a syntax identical to the _a_t(1) command. For each job that is queued, _s_e_n_d_f_a_x prints a _j_o_b _i_d_e_n_t_i_f_i_e_r and a _j_o_b _g_r_o_u_p _i_d_e_n_t_i_f_i_e_r on the standard output. A job identifier is the token by which jobs are identified within _H_y_l_a_F_A_X; job group identifiers are used to reference a set of jobs that have been submitted at the same time. Job and job group identifiers can be supplied to the _f_a_x_r_m(1) command to remove the jobs or to the _f_a_x_a_l_t_e_r(1) command to alter job parameters. Facsimile are made from the concatenation of a cover page (see below) and one or more files specified on the command line. If no files are supplied on the command line, _s_e_n_d_f_a_x will read data from the standard input unless polling is requested. Cover pages are distinguished for the purpose of generating ``_c_o_n_t_i_n_u_a_t_i_o_n _c_o_v_e_r _p_a_g_e_s'' on the server; these are makeup cover pages that are automatically generated if a job fails after sending the original user-specified cover page. _s_e_n_d_f_a_x passes POSTSCRIPT and TIFF documents directly through to the fax server for transmission, and attempts to convert other file formats to either POSTSCRIPT or TIFF. In normal operation _s_e_n_d_f_a_x automatically converts ASCII-text, _t_r_o_f_f(1) output, and Silicon Graphics format images for transmission. Support for other file formats can be easily added through an extensible file typing and conversion facility; see _t_y_p_e_r_u_l_e_s(4F). Note that since TIFF Class F documents are processed directly it is simple to forward a received facsimile. By default _s_e_n_d_f_a_x will generate a cover page for each facsimile that is to be transmitted. This cover page is created by the ancillary _f_a_x_c_o_v_e_r(1) program using information deduced by _s_e_n_d_f_a_x and by information supplied on the command line. Automatic cover page generation may be suppressed with the ----nnnn option. In addition to sending documents, _s_e_n_d_f_a_x can be used to poll a remote facsimile machine to retrieve waiting documents. If the ----pppp option is specified, a polling request will be submitted to each destination. If a poll request is Page 1 (printed 6/24/99) SSSSEEEENNNNDDDDFFFFAAAAXXXX((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((JJJJuuuunnnneeee 22221111,,,, 1111999999996666)))) SSSSEEEENNNNDDDDFFFFAAAAXXXX((((1111)))) made in conjunction with the transmission of documents, the poll request will take place after the documents are transmitted. Documents retrieved by polling are returned to the requestor by electronic mail and may be viewed with a suitable viewer program. One or more destinations must be specified on the command line using the ----dddd option. A destination is the dialing string to use to contact the remote fax machine. Phone numbers may include non-alphanumeric characters for readability-only alphanumerics and ``+'' (for denoting a country code) are significant in placing a call. Alphabetic characters are automatically mapped to their numeric key equivalents: ``abcABC'' to ``2'', ``defDEF'' to ``3'', etc. Dialing prefixes, such as ``1'' and ``011'' (for long distance calling in the United States) need not be included if an unambigous number is specified. Examples of unambiguous phone numbers are: +31.77.594.131 _t_o _c_a_l_l _t_h_e _N_e_t_h_e_r_l_a_n_d_s +14159657824 _t_o _c_a_l_l _C_a_l_i_f_o_r_n_i_a 9657824 _t_o _m_a_k_e _a _l_o_c_a_l _c_a_l_l 1-215-356-1666 _t_o _c_a_l_l _P_e_n_n_s_y_l_v_a_n_i_a _f_r_o_m _w_i_t_h_i_n _t_h_e _U_S Non-numeric strings, such as ``*70'' (to defeat call waiting), may be included in the destination phone number. Whether or not they are stripped from the string used to dial the destination fax machine is dependent on the dialstring rules configured for use on the server; c.f. _c_o_n_f_i_g(4F) and _d_i_a_l_r_u_l_e_s(4F). A destination may also be specified as _u_s_e_r@_f_a_x-_n_u_m_b_e_r. In this case the _u_s_e_r string will be passed to _f_a_x_c_o_v_e_r as the identity of the recipient. Note that multi-word names must be enclosed in quote marks; for example, ``Sam Leffler@+1.415.555.1212''. The order of options on the command line is significant. Each fax to be transmitted is assigned the current value of parameters specified on the command line; e.g. whether or not to generate a cover page. This means that options that specify parameters for a particular destination must precede the dialstring specified with the ----dddd option. For example, sendfax -n -d 5551212 /etc/passwd submits a fax to 5551212 that has no cover page while sendfax -d 5551212 -n /etc/passwd submits the same fax but with the default cover page handling. Note also that parameter values persist across ----dddd options so the following Page 2 (printed 6/24/99) SSSSEEEENNNNDDDDFFFFAAAAXXXX((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((JJJJuuuunnnneeee 22221111,,,, 1111999999996666)))) SSSSEEEENNNNDDDDFFFFAAAAXXXX((((1111)))) sendfax -n -d 5551212 -d 5551313 /etc/network submits two facsimile, both of which have no cover page. OOOOPPPPTTTTIIIIOOOONNNNSSSS ----1111 Transmit facsimile documents using 1-D MR compression. By default _H_y_l_a_F_A_X will use the optimal compression scheme supported by the transmitting modem and receiving facsimile device. ----2222 Transmit facsimile documents using 2-D MR compression, if possible. By default _H_y_l_a_F_A_X will use the optimal compression scheme supported by the transmitting modem and receiving facsimile device. ----aaaa _t_i_m_e Schedule transmission at the indicated _t_i_m_e. Times are specified using the syntax of the _a_t(1) command; e.g. ``now + 30 minutes'' to schedule transmission 30 minutes in the future. By default, _s_e_n_d_f_a_x schedules facsimile for ``now''. ----bbbb _s_p_e_e_d Transmit facsimile documents using a signalling rate that is constrained to be at least _s_p_e_e_d bits/second. If the specified speed is greater than the transmitting modem or receiver is capable of, it is reduced to the highest possible speed both devices support. If a negotiated signalling rate greater than or equal to _s_p_e_e_d cannot be negotiated then the job is aborted. Possible speeds are: 2400, 4800, 7200, 9600, 12000, and 14400. By default _H_y_l_a_F_A_X will use the fastest possible rate supported by the transmitting modem and receiving facsimile device. ----BBBB _s_p_e_e_d Try to transmit facsimile documents using the desired signalling rate. Possible speeds are: 2400, 4800, 7200, 9600, 12000, and 14400. If the specified speed is greater than the transmitting modem or receiver is capable of, it is reduced to the highest possible speed both devices support. By default _H_y_l_a_F_A_X will use the fastest possible rate supported by the transmitting modem and receiving facsimile device (unless restricted by other server configuration); this option can be used to reduce the speed. Note that international calls are frequently more reliable when transmissions are restricted to 9600 bits/second. Page 3 (printed 6/24/99) SSSSEEEENNNNDDDDFFFFAAAAXXXX((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((JJJJuuuunnnneeee 22221111,,,, 1111999999996666)))) SSSSEEEENNNNDDDDFFFFAAAAXXXX((((1111)))) ----cccc _c_o_m_m_e_n_t_s Pass _c_o_m_m_e_n_t_s to the _f_a_x_c_o_v_e_r(1) program for inclusion in the comments field of any generated cover page. ----DDDD Enable notification by electronic mail when the facsimile has been delivered. By default _H_y_l_a_F_A_X will notify the submitter only if there is a problem with a job. ----dddd _d_e_s_t_i_n_a_t_i_o_n Create a job to transmit the supplied documents to a facsimile machine at the indicated _d_e_s_t_i_n_a_t_i_o_n. If the _d_e_s_t_i_n_a_t_i_o_n is of the form ``_u_s_e_r@_p_h_o_n_e-_n_u_m_b_e_r'' then any cover page will show _u_s_e_r as the intended receipient. ----EEEE Disable use of the Error Correction Mode (ECM) when transmitting page data. By default _H_y_l_a_F_A_X will attempt to use ECM when both the trasmitting modem and receiving device support it. Note that international calls are sometimes faster when ECM is disabled. Beware also that some modems and/or facsimile devices do not properly implement ECM causing transmission failures. ----ffff _f_r_o_m Use _f_r_o_m as the identity of the facsimile sender. Otherwise the sender is the user that invoked _s_e_n_d_f_a_x. The sender is an account name to which the _H_y_l_a_F_A_X software should direct notification messages. The _f_r_o_m identity may be a fullblown ``From:'' line, e.g. e.g. ``Joe Blow <joe@foo.com>'' and ``joe@foo.com (Joe Blow)'' are acceptable. If no host-part is specified in the _f_r_o_m string the local hostname is used. This option is useful when _s_e_n_d_f_a_x is invoked on behalf of another user, such as in the implementation of an electronic mail to fax gateway. ----FFFF _f_o_r_m_a_t Use the specified _f_o_r_m_a_t when imaging tag lines on outgoing pages. Consult the description of the TTTTaaaaggggLLLLiiiinnnneeeeFFFFoooorrrrmmmmaaaatttt parameter in _c_o_n_f_i_g(4F) for an explanation of how to construct a format string. _N_o_t_e _t_h_a_t _m_a_n_y _l_o_c_a_l_e_s _r_e_q_u_i_r_e _t_h_a_t _p_r_o_p_e_r _i_d_e_n_t_i_f_i_c_a_t_i_o_n _a_p_p_e_a_r _o_n _a_l_l _t_r_a_n_s_m_i_t_t_e_d _f_a_c_s_i_m_i_l_e; _w_h_e_n _u_s_i_n_g _t_h_i_s _f_a_c_i_l_i_t_y _o_n_e _s_h_o_u_l_d _a_l_w_a_y_s _i_n_c_l_u_d_e _p_r_o_p_e_r _i_d_e_n_t_i_f_i_c_a_t_i_o_n (_e._g. _a _p_h_o_n_e _n_u_m_b_e_r) _i_n _t_h_e _i_m_a_g_e_d _t_a_g_l_i_n_e_s. ----hhhh [_m_o_d_e_m@]_h_o_s_t[:_p_o_r_t] Page 4 (printed 6/24/99) SSSSEEEENNNNDDDDFFFFAAAAXXXX((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((JJJJuuuunnnneeee 22221111,,,, 1111999999996666)))) SSSSEEEENNNNDDDDFFFFAAAAXXXX((((1111)))) Force the jobs to be processed on a specific _h_o_s_t and, optionally, using a particular _m_o_d_e_m. The _h_o_s_t may be either a symbolic name or a network address. If no ----hhhh option is supplied, _s_e_n_d_f_a_x uses the FAXSERVER environment variable to identify the _H_y_l_a_F_A_X server to which the jobs should be directed. If no server is specified then _s_e_n_d_f_a_x attempts to contact a server on the local host. If no modem is specified, the job will be submitted to any available modem. ----iiii _i_d_e_n_t_i_f_i_e_r Use the _i_d_e_n_t_i_f_i_e_r string in any notification messages instead of the usual job identifier number. This option is useful for applications that cross reference notification messages against job submissions. ----IIII _t_i_m_e If a job must be requeued because of a communication failure schedule the retry according to the specified _t_i_m_e. Times are given in seconds. Minutes, hours, and days can be specified with ``_m_i_n'', ``_h_o_u_r'', and ``_d_a_y'' suffixes, respectively. By default _H_y_l_a_F_A_X reschedules jobs using retry times that depend on the manner in which the job failed; this interface permits a user to override this algorithm and specify a single fixed retry time for all communication failures. ----kkkk _t_i_m_e Kill the job if it does not complete in the indicated _t_i_m_e. As for the ----aaaa option, the _t_i_m_e is specifed using notation compatible with _a_t(1). Note that the _t_i_m_e is relative to the time of the initial transmission attempt. The default kill time is ``now +1 day'' (one day from the time the job is first processed). To retry for an hour, ``now +1 hour'' could be used. ----llll Transmit the facsimile at a vertical resolution of 98 lines/inch; otherwise known as _l_o_w _r_e_s_o_l_u_t_i_o_n. ----mmmm Transmit the facsimile at a vertical resolution of 196 lines/inch; otherwise known as _m_e_d_i_u_m _r_e_s_o_l_u_t_i_o_n or _f_i_n_e _m_o_d_e. ----MMMM _m_s_t Transmit facsimile documents using the specified minimum scanline time. Possible times are: 0ms, 5ms, 10ms2, 10ms, 20ms2, 20ms, 40ms2, and 40ms. If the specified time is less than the Page 5 (printed 6/24/99) SSSSEEEENNNNDDDDFFFFAAAAXXXX((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((JJJJuuuunnnneeee 22221111,,,, 1111999999996666)))) SSSSEEEENNNNDDDDFFFFAAAAXXXX((((1111)))) transmitting modem or receiver is capable of, it is increased to the lowest possible time both devices support. By default _H_y_l_a_F_A_X will use the lowest possible time supported by the transmitting modem and receiving facsimile device (unless restricted by other server configuration). This option is mostly useful for debugging. ----nnnn Suppress the automatic generation of a cover page for subsequent facsimile. Note that polling requests do not receive a cover page unless they are combined with the transmission of one or more files. ----NNNN Do not notify the sender by electronic mail when the facsimile has been delivered or requeued. ----pppp Poll each destination for any available documents. If a poll request is made together with document transmission, the poll operation is done after the documents are transmitted. Documents received by polling are returned to the sender by electronic mail. ----PPPP _p_r_i_o_r_i_t_y Assign the specified scheduling _p_r_i_o_r_i_t_y to subsequent jobs. A priority is an integer value in the range [0-255]. Lower values result in higher priority processing. By default, each job is assigned 127 for an initial scheduling priority. A job's priority is raised (numerically lowered) for each failed attempt to transmit so that retransmit attempts are done ahead of newly submitted jobs. The _p_r_i_o_r_i_t_y may also be specified as one of the following symbolic names: _d_e_f_a_u_l_t or _n_o_r_m_a_l (127), _b_u_l_k or _j_u_n_k (207), _h_i_g_h (63). ----RRRR Enable notification by electronic mail when the facsimile has been delivered and when it is requeued for retransmission. By default _H_y_l_a_F_A_X will notify the submitter only if there is a problem with a job. ----rrrr _r_e_g_a_r_d_i_n_g Pass _r_e_g_a_r_d_i_n_g to the _f_a_x_c_o_v_e_r(1) program as the value of the ``Re:'' field of any generated cover page. ----ssss _s_i_z_e Set the page size to use for the transmitted facsimile. Facsimile are normally imaged with a system-default page size (usually letter-size Page 6 (printed 6/24/99) SSSSEEEENNNNDDDDFFFFAAAAXXXX((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((JJJJuuuunnnneeee 22221111,,,, 1111999999996666)))) SSSSEEEENNNNDDDDFFFFAAAAXXXX((((1111)))) pages, 8.5" by 11", for sites in North America). Alternate page sizes are specified symbolically using either the name or abbreviation of an entry in the _p_a_g_e_s_i_z_e_s(4F) database; e.g. _a_3 (ISO A3), _a_4 (ISO A4), _a_5 (ISO A5), _a_6 (ISO A6), _b_4 (ISO B4), _n_a-_l_e_t (North American Letter), _u_s-_l_e_g (American Legal), _u_s-_l_e_d (American Ledger), _u_s-_e_x_e (American Executive), _j_p-_l_e_t (Japanese Letter), and _j_p-_l_e_g (Japanese Legal). Comparisons are case-insensitive and any match of a substring of the full page-size name is sufficient; e.g. ``legal'' would match ``American Legal''. Note that it may not be permissible to image into the full page area; the guaranteed reproducible area for a page is typically inset. Also, note that while arbitrary page sizes can be specified through the page size database, only a limited set of page dimensions are supported by the Group 3 facsimile protocol. Thus if an odd-size facsimile is submitted for transmission it may not be possible to determine if it can be sent until the fax server establishes communication with the remote facsimile machine. ----tttt _t_r_i_e_s Make no more than _t_r_i_e_s attempts to send the facsimile. By default, _H_y_l_a_F_A_X will terminate a job if: 3 consecutive attempts to send a particular page fail, or it appears the receiver is not a facsimile machine. Otherwise _H_y_l_a_F_A_X places no limit on the _n_u_m_b_e_r of attempts to send a facsimile, instead terminating a job if it is not completed within a _k_i_l_l _t_i_m_e timeout interval. Note that a try is a call in which carrier is established and the facsimile protocol is commenced; this is contrasted with a call attempt that might have failed because the line was busy. ----xxxx _c_o_m_p_a_n_y Pass _c_o_m_p_a_n_y to the _f_a_x_c_o_v_e_r(1) program as the destination company name. ----yyyy _l_o_c_a_t_i_o_n Pass _l_o_c_a_t_i_o_n to the _f_a_x_c_o_v_e_r(1) program as the destination company's location. ----vvvv Print information on the standard output about each conversion and cover sheet generation operation it does. If ----vvvv is specified twice, the protocol between _s_e_n_d_f_a_x and the _h_f_a_x_d server process that does the submission work on Page 7 (printed 6/24/99) SSSSEEEENNNNDDDDFFFFAAAAXXXX((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((JJJJuuuunnnneeee 22221111,,,, 1111999999996666)))) SSSSEEEENNNNDDDDFFFFAAAAXXXX((((1111)))) the remote machine is also displayed. CCCCOOOONNNNFFFFIIIIGGGGUUUURRRRAAAATTTTIIIIOOOONNNN PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS _s_e_n_d_f_a_x reads configuration information from the files ////uuuussssrrrr////ffffrrrreeeeeeeewwwwaaaarrrreeee////lllliiiibbbb////ffffaaaaxxxx////hhhhyyyyllllaaaa....ccccoooonnnnffff, ////uuuussssrrrr////ffffrrrreeeeeeeewwwwaaaarrrreeee////lllliiiibbbb////ffffaaaaxxxx////sssseeeennnnddddffffaaaaxxxx....ccccoooonnnnffff, and ~~~~////....hhhhyyyyllllaaaarrrrcccc; in that order. Configuration files follow the conventions described in _h_y_l_a_f_a_x(1). The following configuration parameters are recognized: TTTTaaaagggg TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn AutoCoverPage boolean Yes automatically generate cover page ChopThreshold float 3.0 page chopping threshold CoverCmd string _s_e_e _b_e_l_o_w pathname of cover sheet program Cover-Comments string - cover page comments string Cover-Company string - cover page company name string Cover-Location string - cover page company location string Cover-Regarding string - cover page regarding string Cover-Template string - cover page template filename Cover-Voice string - cover page voice number string DateFormat string - cover page date format string DesiredEC boolean - desired use of ECM DesiredMST string - desired minimum scanling time to use DesiredSpeed integer - desired signalling rate to use DialRules string _s_e_e _b_e_l_o_w file containing dialstring rules From string - sender's identity HRes float 204. horizontal resolution Host string localhost host to contact for service KillTime string - time to expire job MailAddr string - mail address for notification messages MaxDials integer 12 times to retry dialing MaxTries integer 3 times to retry transmission MinSpeed integer - minimum acceptable signalling rate Modem string - modem to use on server Notify string none control email notification PageChop string default control page chop handling PageLength float - page length in millimeters PageSize string default page size by name PageWidth float - page width in millimeters Port integer 4559 port to use in contacting server Priority string default job scheduling priority Protocol string tcp protocol to use in contacting server RetryTime string - delay between failed attempts to send SendTime string - time to send job TagLine string - tagline format string TypeRules string _s_e_e _b_e_l_o_w file containing file typing rules VRes float 98. vertical resolution Verbose boolean No whether or not to enable protocol tracing The configuration parameters are explained below. Certain configuration parameters, notably those for setting strings on automatically generated cover pages, are defined mainly for use by other _H_y_l_a_F_A_X programs that share common code Page 8 (printed 6/24/99) SSSSEEEENNNNDDDDFFFFAAAAXXXX((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((JJJJuuuunnnneeee 22221111,,,, 1111999999996666)))) SSSSEEEENNNNDDDDFFFFAAAAXXXX((((1111)))) used by _s_e_n_d_f_a_x. AAAAuuuuttttooooCCCCoooovvvveeeerrrrPPPPaaaaggggeeee Control whether or not a cover page is automatically generated for each job. (Equivalent to the ----nnnn option.) CCCChhhhooooppppTTTThhhhrrrreeeesssshhhhoooolllldddd The amount of white space, in inches, that must be present at the bottom of a page before _H_y_l_a_F_A_X will attempt to truncate the page transmission. CCCCoooovvvveeeerrrrCCCCmmmmdddd The absolute pathname of the program to use to generate cover pages. The default cover sheet program is ////uuuussssrrrr////ffffrrrreeeeeeeewwwwaaaarrrreeee////bbbbiiiinnnn////ffffaaaaxxxxccccoooovvvveeeerrrr. CCCCoooovvvveeeerrrr----CCCCoooommmmmmmmeeeennnnttttssss The comments string to pass to the cover sheet program when auto-generating cover pages. CCCCoooovvvveeeerrrr----CCCCoooommmmppppaaaannnnyyyy The company name string to pass to the cover sheet program when auto-generating cover pages. CCCCoooovvvveeeerrrr----LLLLooooccccaaaattttiiiioooonnnn The company location string to pass to the cover sheet program when auto-generating cover pages. CCCCoooovvvveeeerrrr----RRRReeeeggggaaaarrrrddddiiiinnnngggg The regarding string to pass to the cover sheet program when auto-generating cover pages. CCCCoooovvvveeeerrrr----TTTTeeeemmmmppppllllaaaatttteeee The absolute pathname of a cover sheet template file to use in auto-generating cover pages. CCCCoooovvvveeeerrrr----VVVVooooiiiicccceeee The voice number string to pass to the cover sheet program when auto-generating cover pages. DDDDaaaatttteeeeFFFFoooorrrrmmmmaaaatttt The _s_t_r_f_t_i_m_e(3) format string to pass to the cover page command when auto-generating cover pages. DDDDeeeessssiiiirrrreeeeddddEEEECCCC Whether or not to request the use of the optional Error Correct Mode (ECM) when transmitting facsimile. (Equivalent to the ----EEEE option.) DDDDeeeessssiiiirrrreeeeddddMMMMSSSSTTTT The desired minimum scanline time to use when transmitting facsimile. (Equivalent to the ----MMMM option.) Page 9 (printed 6/24/99) SSSSEEEENNNNDDDDFFFFAAAAXXXX((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((JJJJuuuunnnneeee 22221111,,,, 1111999999996666)))) SSSSEEEENNNNDDDDFFFFAAAAXXXX((((1111)))) DDDDeeeessssiiiirrrreeeeddddSSSSppppeeeeeeeedddd The desired signalling rate to the use when transmitting facsimile. (Equivalent to the ----BBBB option.) DDDDiiiiaaaallllRRRRuuuulllleeeessss The name of the file containing the dialstring processing rules to when preparing an externally visible representation of the dialstring (e.g. to strip credit card numbers). By default this is /usr/freeware/lib/fax/dialrules. FFFFrrrroooommmm The sender's identity. (Equivalent to the ----ffff option.) HHHHoooosssstttt The host to contact for service. (Equivalent to the ----hhhh option.) HHHHRRRReeeessss The horizontal resolution to use when transmitting facsimile. (NB: _t_h_i_s _c_u_r_r_e_n_t_l_y _h_a_s _n_o _e_f_f_e_c_t.) KKKKiiiillllllllTTTTiiiimmmmeeee The expiration time to assign to each job. (Equivalent to the ----kkkk option.) MMMMaaaaiiiillllAAAAddddddddrrrr The electronic mail address to direct notification messages from the server. If this string is specified without an ``@hostname'' part then the local hostname will automatically be appended. (Equivalent to the ----ffff option.) MMMMaaaaxxxxDDDDiiiiaaaallllssss The maximum number of times to dial the phone for each job. (Equivalent to the ----TTTT option.) MMMMaaaaxxxxTTTTrrrriiiieeeessss The maximum number of times to retry sending a job. (Equivalent to the ----tttt option.) MMMMiiiinnnnSSSSppppeeeeeeeedddd The minimum acceptable signalling rate to use when transmitting facsimile. (Equivalent to the ----bbbb option.) MMMMooooddddeeeemmmm The modem to use on the server. (Equivalent to the ----hhhh option.) NNNNoooottttiiiiffffyyyy Control the email notification messages from the server. This string may be one of ``done'', ``none'', ``requeued'' or ``default'' with an optionally preceding ``when '' (e.g. ``when done''). Note that ``when requeued'' implies ``when done''. (Equivalent to the ----DDDD, ----RRRR, and ----NNNN options.) Page 10 (printed 6/24/99) SSSSEEEENNNNDDDDFFFFAAAAXXXX((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((JJJJuuuunnnneeee 22221111,,,, 1111999999996666)))) SSSSEEEENNNNDDDDFFFFAAAAXXXX((((1111)))) PPPPaaaaggggeeeeCCCChhhhoooopppp Control page chop handling when transmitting facsimile. This string may be one of ``none'', ``all'', or ``last' to have no pages chopped, all pages chopped, or only the last page chopped; respectively. Page chopping is controlled by the CCCChhhhooooppppTTTThhhhrrrreeeesssshhhhoooolllldddd parameter. PPPPaaaaggggeeeeLLLLeeeennnnggggtttthhhh Set the transmitted page length in millimeters. PPPPaaaaggggeeeeSSSSiiiizzzzeeee Set the page dimensions according to an entry in the _p_a_g_e_s_i_z_e_s(4F) database. (Equivalent to the ----ssss option.) PPPPaaaaggggeeeeWWWWiiiiddddtttthhhh Set the transmitted page width in millimeters. PPPPoooorrrrtttt The network port to contact for service. (Eqvuialent to the ----hhhh option.) PPPPrrrriiiioooorrrriiiittttyyyy The scheduling priority to assign to each job. (Equivalent to the ----PPPP option.) PPPPrrrroooottttooooccccoooollll The name of the communication protocol to use when contacting a server. (Equivalent to the FFFFAAAAXXXXSSSSEEEERRRRVVVVIIIICCCCEEEE environment variable.) RRRReeeettttrrrryyyyTTTTiiiimmmmeeee The time to delay between job retries due to a communication failure. (Equivalent to the ----IIII option.) SSSSeeeennnnddddTTTTiiiimmmmeeee The time to send jobs. (Equivalent to the ----aaaa option.) TTTTaaaaggggLLLLiiiinnnneeee The tagline format string to use when transmitting facsimile. (Equivalent to the ----FFFF option.) TTTTyyyyppppeeeeRRRRuuuulllleeeessss The name of the file containing file type conversion rules. By default this is /usr/freeware/lib/fax/typerules. VVVVeeeerrrrbbbboooosssseeee Control protocol tracing. (Equivalent to the ----vvvvvvvv option.) VVVVRRRReeeessss Set the vertical resolution in lines/inch to use when transmitting facsimile. (Equivalent to the ----mmmm and ----llll options.) DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS The following messages are generated because of problems Page 11 (printed 6/24/99) SSSSEEEENNNNDDDDFFFFAAAAXXXX((((1111)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((JJJJuuuunnnneeee 22221111,,,, 1111999999996666)))) SSSSEEEENNNNDDDDFFFFAAAAXXXX((((1111)))) encountered on the local machine. CCCCoooouuuulllldddd nnnnooootttt ccccaaaallllllll sssseeeerrrrvvvveeeerrrr.... The facsimile server on the remote machine did not respond. NNNNoooo iiiinnnnppppuuuutttt ddddaaaattttaaaa;;;; ttttrrrraaaannnnmmmmiiiissssssssiiiioooonnnn aaaabbbboooorrrrtttteeeedddd.... No data was supplied (typically on the standard input). No facsimile will be sent. EEEErrrrrrrroooorrrr ccccoooonnnnvvvveeeerrrrttttiiiinnnngggg ddddaaaattttaaaa;;;; ccccoooommmmmmmmaaaannnndddd wwwwaaaassss %%%%ssss...."""" A data conversion operation failed; the shell command that was used is printed. CCCCaaaannnn nnnnooootttt ccccoooonnnnvvvveeeerrrrtttt %%%%ssss.... Data needed to be converted for transmission, but the required conversion rule was not located. This may indicate that the _H_y_l_a_F_A_X software was incorrectly installed; or perhaps that an NFS-mounted directory is temporarily unavailable. %%%%ssss:::: CCCCaaaannnn nnnnooootttt ddddeeeetttteeeerrrrmmmmiiiinnnneeee ffffiiiilllleeee ttttyyyyppppeeee.... _s_e_n_d_f_a_x was unable to deduce the type of the file. %%%%ssss:::: NNNNooootttt aaaa rrrreeeegggguuuullllaaaarrrr ffffiiiilllleeee.... The file is something other than a regular file; for example, a directory. The following messages may be printed by _s_e_n_d_f_a_x. These messages describe problems encountered by the server process on the remote machine. This list is incomplete; other messages may be generated by the server under unusual circumstances. FFFFIIIILLLLEEEESSSS ~/.hylarc per-user configuration file /usr/freeware/lib/fax/hyla.conf system-wide configuration file /usr/freeware/lib/fax/sendfax.conf system-wide configuration file /usr/freeware/lib/fax/typerules file type and conversion rules /usr/freeware/lib/fax/pagesizes page size database /usr/freeware/lib/fax/dialrules optional client dialstring rules /usr/freeware/bin/faxcover for generating cover sheets /usr/freeware/sbin/textfmt for converting text to PostScript /usr/freeware/sbin/sgi2fax for converting SGI RGB images /usr/tmp/sndfaxXXXXXX temporary files SSSSEEEEEEEE AAAALLLLSSSSOOOO _a_t(1), _h_y_l_a_f_a_x(1), _f_a_x_a_l_t_e_r(1), _f_a_x_c_o_v_e_r(1), _f_a_x_m_a_i_l(1), _f_a_x_r_m(1), _f_a_x_s_t_a_t(1), _s_g_i_2_f_a_x(1), _t_e_x_t_f_m_t(1), _h_f_a_x_d(1M), _h_y_l_a_f_a_x(4F), _t_y_p_e_r_u_l_e_s(4F) Page 12 (printed 6/24/99) 
